This page last changed on Jan 02, 2007 by rosie@atlassian.com.

You need to edit in 'Wiki Markup' mode to include macros in your page.

The Include Page Macro allows you to display the contents of one Confluence page in another.

To display a page's contents, you require 'View' permission for that page. This is assigned by a space administrator from the Space Administration screens. See Space Permissions or contact a space administrator for more information.

Include Page Macro

What you need to type What you will get
{include:Sample Include Page}

Start of sample page content

Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam fermentum vestibulum est. Cras rhoncus. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Sed quis tortor. Donec non ipsum. Mauris condimentum, odio nec porta tristique, ante neque malesuada massa, in dignissim eros velit at tellus. Donec et risus in ligula eleifend consectetuer. Donec volutpat eleifend augue. Integer gravida sodales leo. Nunc vehicula neque ac erat. Vivamus non nisl. Fusce ac magna. Suspendisse euismod libero eget mauris.

End of sample page content

Where:

'Sample Include Page' is the title of the page whose contents you want to display.


Optional Parameter

Display contents of a page located in another space

{include:ds:Confluence Overview}

Where:

'DS' is the spacekey of the other space.
'Confluence Overview' is the name of the page whose contents you want to display.

RELATED TOPICS

Working with Macros

Take me back to Confluence 2 Home

Are these includes cached as part of regular page caching?

Posted by bagheera at Mar 30, 2006 06:50

In order to provide users of my wiki space with something to read and review offline on the train (!), I created a page which used the {include} macro to create a page made up of multiple other pages, effectively:

{include:chapter 1}
{include:chapter 2}
{include:chapter 3}
...

The export page to PDF option (icon at top right of screen works well for the text - but it omits any images on the included pages. Is this a bug? or a feature?

The individual pages (chapter 1, chapter 2, etc) export to PDF with images ok on their own.

Posted by ameban at May 11, 2006 09:43

Hi Alan,
I have created an issue regarding
http://jira.atlassian.com/browse/CONF-6436
Please add a watch to it for updates.
Thanks,
Ivan

Posted by ivan@atlassian.com at Jun 23, 2006 01:55

Is it possible to use macros in combination so that you can include only portions of one page in another, rather than only being able to include a whole page?

Posted by sltrunzo at Oct 16, 2006 15:15

You can use {excerpt-include:<page-name>} to include the portion of a page surrounded by {excerpt} tags.

Posted by ameban at Oct 16, 2006 16:03

I'd like to have another optional parameter "labels=true" whereby the labels of the included page will be associated with the including page. This would be very useful to manage labels used on included pages in the same way that the

Unknown macro: {add-label}
and
Unknown macro: {choose-label}
macros work with page templates.

In my case I have labels on various distribution notice pages. I would like the labels to be automatically attached to any page that uses the distribution notice so that I can easily check that all content has the correct distribution notice.

I've created an issue here: CONF-7309

In the meantime I can use the

metadata: Required parameter "0" not provided
plugin for the same purpose, but it is more complicated and therefore less approachable for others in my organisation to implement themselves.

Posted by jibjab at Nov 13, 2006 09:38

sorry forgot to escape the macros

Posted by jibjab at Nov 15, 2006 05:04

It should be added to the documentation that pages referenced on the include page macro (and other similar macros) do not get automatically changed when the page is renamed. This is a significant inhibitor to using this capability.

Posted by bob.swift@lakeviewtech.com at Nov 15, 2006 09:23

is there a way to include a page and all its child pages..rather than doing it one by one?

Posted by ankur.gupta@globallogic.com at Dec 17, 2006 22:35
Document generated by Confluence on Feb 05, 2007 23:34